home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Diamond Collection / The Diamond Collection (Software Vault)(Digital Impact).ISO / cdr42 / xmstr201.zip / XMSTR20.DOC < prev   
Text File  |  1995-02-14  |  50KB  |  1,142 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  17.  
  18.         ██   ██         ██   ██   ███    █████   ██████ ███████ ██████
  19.          ██ ██          ███ ███  ██ ██  ██   ██  █ ██ █  ██   █  ██  ██
  20.           ███           ███████ ██   ██ ███        ██    ██      ██  ██
  21.           ███    ██████ ██ █ ██ ██   ██   ███      ██    ████    █████
  22.          ██ ██          ██   ██ ███████     ███    ██    ██      ████
  23.         ██   ██         ██   ██ ██   ██ ██   ██    ██    ██   █  ██ ██
  24.         ██   ██         ██   ██ ██   ██  █████    ████  ███████ ███  ██
  25.  
  26. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  27.  
  28.                        The ULTIMATE in CONTROL for
  29.  
  30.                                 all your
  31.  
  32.                        EXTENSION specific programs
  33.  
  34.                                   v2.0
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  46.  
  47.  
  48. Table of Contents
  49.  
  50.     An introduction of sorts .................................... 4
  51.     Enter X-MASTER .............................................. 5
  52.     QuickStart for the impatient ................................ 6
  53.     Upgrading from a previous version of X-MASTER ............... 7
  54.     Getting Started ............................................. 8
  55.     Notes on batch files ........................................ 9
  56.     Getting around in X-MASTER .................................. 10
  57.     Options available ........................................... 11
  58.     Multiple Extension Lists (MEL's) ............................ 12
  59.     Mega-Extensions ............................................. 13
  60.     Colors....................................................... 14
  61.     NON-VGA users! .............................................. 15
  62.     XMREPORT .................................................... 16
  63.     Files in use by X-MASTER .................................... 17
  64.     Optimizing X-MASTER! ........................................ 18
  65.     Why X-MASTER? ............................................... 19
  66.     Known pitfalls .............................................. 20
  67.     Troubleshooting ............................................. 21
  68.     Command line options ........................................ 22
  69.     Tested extensions ........................................... 23
  70.     Contacting the author ....................................... 24
  71.     Kudos, Legal BS ............................................. 25
  72.     Shareware! .................................................. 26
  73.     Why register? ............................................... 27
  74.     Free copy? .................................................. 28
  75.     Vendor Info ................................................. 29
  76.  
  77.  
  78. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  79.  
  80.  
  81. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  82.  
  83.  
  84.                      ** An introduction of sorts **
  85.  
  86. Scenario ONE -
  87.  
  88.         You own a Sound Blaster card, and you have been amassing
  89.     an enormous collection of MOD files, as well as a few ROL files, and
  90.     a few CMF's.  You only have a 60mb HD, and have to keep all these
  91.     files compressed as to conserve space.  Everytime you wish to play
  92.     one of the MOD's, you have to uncompress the file, play it, and then
  93.     delete it after hearing it.  Kind of a pain...
  94.  
  95. Scenario TWO -
  96.  
  97.         You own a VGA card and have been collecting a bunch of FLI's.
  98.     These are incredible space takers, so keeping them unarchived does
  99.     not make any sense, so you ARJ a few of them, ZIP some of the
  100.     others, and LZH the rest.  Unfortunately, not one program can undo
  101.     all the aforementioned archives, so you have to continually remember
  102.     which one is compressed with which archive, or repeatedly take 
  103.     directories.  Even more of a pain, especially if you spell one 
  104.     wrong...
  105.  
  106. Scenario THREE -
  107.  
  108.         You own the ultimate multi-media machine and have the same
  109.     problems as the two people mentioned above, but since you have a
  110.     660mb HD, your problems are ten times worse!  What you need is a
  111.     program which is easy to configure, will automatically choose which
  112.     unarchiver and player to use, and give you the ability to play /
  113.     view all the various extensions without the added headaches...
  114.  
  115.  
  116. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  117.  
  118.  
  119. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  120.  
  121.  
  122.                           ** Enter X-MASTER **
  123.  
  124.     X-MASTER is the program you need to aid you in combatting the above
  125. scenarios.  So what is it you might ask?  X-MASTER will give you a menu
  126. to choose which file you wish to play / view / use.  If the file is
  127. archived using one of the three most popular archivers, X-MASTER will
  128. unarchive it for you to a place of your choosing, use the file as
  129. directed, and then delete it once complete.  In the BBS' world, there
  130. are so many programs that do different things, but programs can usually
  131. be classified by their three character extension (i.e. .ZIP files are
  132. usually compressed with PKZIP by Phil Katz; .MOD files are usually Amiga
  133. Music files which require an external program, such as MODPLAY, to
  134. use...)  Generally speaking, most people keep all there MOD's, VOC's,
  135. FLI's, etc... in a particular directory, a default directory in other
  136. words.
  137.  
  138. X-MASTER has the following features :
  139.  
  140.         ■  Easy to configure
  141.         ■  Support for ARJ'ed, LZH'ed and ZIP'ed files
  142.         ■  Mouse support
  143.         ■  An attractive display with an easy to operate menu
  144.         ■  Ability to sort files by extension/name/date/size and save in
  145.             sorted order.
  146.         ■  Supports any and all extensions / players / viewers which
  147.             support a command line option (or not!)
  148.         ■  Supports multiple directories of the same extension
  149.         ■  Ability to delete files from archives without leaving
  150.             the program
  151.         ■  Support for multiple players / viewers  (Up to 35!)
  152.         ■  Speedier than the average program by using special
  153.             AutoMagic files
  154.         ■  Will unarchive the file where ever you wish including
  155.             a RAMDRIVE for added speed
  156.         ■  Ability to "tag" files for playing / viewing to create
  157.             a jukebox or video show
  158.         ■  Can compile several directories worth of same extension'ed
  159.             files into one big list
  160.         ■  Support for 25/43/50 line modes
  161.         ■  Support ZIP/ARJ file comments for describing the file
  162.         ■  Supports XMS/EMS/DISK swapping
  163.         ■  Can configure X-MASTER to play demos, provided they don't
  164.             require a system recofiguration to work
  165.         ■  Support for playing a different extensions from one menu
  166.         ■  Configurable colors
  167.         ■  Allows one to tag/untag by wildcard
  168.         ■  Allows multiple work directories to be defined
  169.         ■  Allows mutli-file programs to be unarchived at once and then
  170.             played
  171.         ■  Generate a report of what files are in what archives
  172.  
  173.  
  174. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  175.  
  176.  
  177. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  178.  
  179.  
  180.                    ** QuickStart for the impatient **
  181.  
  182.     X-MASTER can be a VERY complex program or a very simple one.  If you
  183. are kind of familiar with X-MASTER or programs similar to it (or you
  184. have experience with batch files and editors), you may be able to
  185. "quick-start" it. I still recommend you scan over the docs after the
  186. initial configuration and discover new features that you never saw
  187. before and do some of the advanced stuff (changing colors, multiple
  188. batch files, etc...).
  189.  
  190.  
  191. If you've never used X-MASTER before :
  192.  
  193.  
  194.     1) Uncompress the contents of the archive into its own directory.
  195.  
  196.     2) Edit the included XMASTER.CFG and suit it to YOUR system.
  197.         (i.e. Change the directories and extensions)
  198.  
  199.     3) Edit the included batch files or make your own for all the
  200.         extensions defined.  (i.e.  Change the ???PLAY?.BAT files)
  201.  
  202.     4) Run XMASTER.EXE.
  203.  
  204.  
  205. If you're upgrading from a previous version :
  206.  
  207.  
  208.     1) Overwrite the old copy of XMASTER.EXE with the new version of the
  209.         EXE.
  210.  
  211.     2) Upgrade the XMASTER.CFG file by running NEWCFG.EXE from the old
  212.         X-MASTER directory.  (See section on "Upgrading from a ..." for
  213.         more info)
  214.  
  215.     3) Run XMASTER.EXE.
  216.  
  217.  
  218.     If you don't have a VGA, please read the section entitled "NON-VGA
  219. Users" before attempting X-MASTER.  Nothing bad will happen, but
  220. everything will be blinking.
  221.  
  222.  
  223. That's it!
  224.  
  225.  
  226. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  227.  
  228.  
  229. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  230.  
  231.  
  232.           ** Upgrading from a previous version of X-MASTER **
  233.  
  234.     Hopefully you managed to get ahold of X-MASTER v1.05 and are wanting
  235. to upgrade from that version.  Because of the extensive changes in the
  236. CFG file, I thought a simple utility would be easiest in going from that
  237. version to this one; so simply run NEWCFG.EXE from your X-MASTER
  238. directory.  NEWCFG will convert the old text CFG to the new fully
  239. formatted CFG file that is necessary for X-MASTER v2.0.
  240.  
  241. Warning : NEWCFG has only been tested on the X-MASTER v1.05 CFG file.
  242.     It may not work with other versions.  It also hasn't been tested
  243.     much, so use with care.  It shouldn't do anything disasterous, just
  244.     not work.
  245.  
  246.  
  247. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  248.  
  249.  
  250. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  251.  
  252.  
  253.                            ** Requirements **
  254.  
  255.     X-MASTER will run on any 286/386/486/Pentium machine with at least
  256. 500K of free memory.  It is recommended that you have an additional 450K
  257. of extended/expanded memory for optimum performance.  If not, X-MASTER
  258. will swap to disk so have at least that much disk space free.  Lastly,
  259. if you've got more memory, set it up for a RAM disk.  There are some
  260. good resizable RAM disk programs out there that will not take up memory
  261. unless you need it.  You will also probably need a hard disk for this
  262. program with enough free space for whatever you wish to extract.  Aside
  263. from that, you don't need much else.  A VGA and a sound card is
  264. recommended.  Without one of these, X-MASTER may be a little less
  265. useful.
  266.  
  267.  
  268. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  269.  
  270.  
  271.                          ** Getting Started **
  272.  
  273.     X-MASTER was made to be a simple program to use, but it requires the
  274. use of many external programs for all features to be implemented.
  275. Furthermore, you may have a hard time working with the config file, but
  276. once you get the hang of it, its easy!  Trust me, proper configuration
  277. of X-MASTER is the hardest thing.  Once over that hump, you're home
  278. free!
  279.  
  280.     Examine the included XMASTER.CFG file, and change it to suit your
  281. system, and file names.  You might be able to use the configuration file
  282. without any changes.
  283.  
  284.     The configuration file has a number of keywords, and after the
  285. keyword is an equal (=) sign and then a parameter.  The keywords are as
  286. follows with a brief description :
  287.  
  288.     Uncompress_Drive    - tells X-MASTER where it can uncompress files.
  289.                             (5)
  290.     ZIP_Prog            - defines a ZIP program to use for deleting from
  291.                             a ZIP.
  292.     UNZIP_Prog          - defines an unzipping program to extract
  293.                             from ZIPs.
  294.     UNZIP_Parameters    - any parameters you need to send to your unzip
  295.                             program.
  296.     LHARC_Prog          - defines your LHA program for extracting LZHs.
  297.     LHARC_Parameters    - any parameters you need to send to your LHARC
  298.                             program.
  299.     ARJ_Prog            - defines your ARJ program for extracting ARJs.
  300.     ARJ_Parameters      - any parameters you need to send to your ARC
  301.                             program.
  302.     Ext                 - defines a normal extension. (40) *
  303.     Ext_Dir             - a directory for a normal extension.  (9)
  304.     Mega_Ext            - defines a MEGA-extension (i.e. demos).
  305.     Mega_Ext_Dir        - a directory for a MEGA-extension.
  306.  
  307.  
  308.     A number in parenthesis indicates the upper limit of the number of
  309. times you may use that parameter.  For EXT and MEGA_EXT, there is a
  310. COMBINED total of 40  (i.e.  you may have a total of 40 extensions /
  311. mega-extensions).   The limit of 40 is also only for the registered
  312. version.  Unregistered, you get a limit of 5.  If there is no number in
  313. parenthesis, then the limit is one.  X-MASTER will let you define a
  314. parameter more than once, but it will use the last one found.
  315.  
  316.     The easiest way to make a config file is to look at the included
  317. config file and change it to meet your needs.  Barring that, put all the
  318. keywords in a text file called XMASTER.CFG and fill them in.  Put all
  319. the EXT's and the MEGA_EXT's at the end with their respective
  320. directories *immediately* following them.  Also, you can do some
  321. formatting/commenting with blank lines or if you wish to add comments,
  322. preface the line with a semi-colon (;).  It is recommended that you do
  323. not put blank lines and/or comments between the EXT/MEGA_EXT's and their
  324. directories.
  325.  
  326.     After completing the configuration file, you are halfway done.  You
  327. must now make a batch file for each extension you put in the con-
  328. figuration file.  The purpose of the batch file is to actually "use"
  329. (play / view / whatever) the file of your selection.  For example, say
  330. you have a FLI extension in your configuration file, and to view the
  331. FLI's, you use the program AAPLAY.EXE.  The batch file would be similar
  332. to :
  333.  
  334. rem This batch file plays FLI's using AAPLAY
  335. E:\VGA\FLIES\AAPLAY %1
  336.  
  337.     Notice that a %1 is in place of where the name of the FLI to view
  338. usually goes.  X-MASTER will pass the name of the FLI by use of DOS
  339. parameters to the batch file.  If you are unsure of how the %variable
  340. notation works, consult your DOS manual.  For most purposes, just place
  341. a %1 where you would normally place the name of the file.
  342.  
  343.     So, how does X-MASTER know which batch file to run??  Well, the name
  344. of the batch file has to be exact for X-MASTER to find it, and it must
  345. follow a very special format.  Each batch file is named by the
  346. extension for which it is going to be used, the word "PLAY" and then a
  347. number starting at "1" and going through "9", (if you use all of those,
  348. go to the letter "A" through "Z") ending with the .BAT extension.  For
  349. example : "FLIPLAY1.BAT" would be the first (default) batch file to be
  350. used to view .FLI files.  Always start with "1" and go up from there.
  351. When you get to "9", start with the letter "A" and go to "Z".  With this
  352. method, you may have up thirty-five batch files available (1-9, A-Z).
  353.  
  354.     You might be wondering how you can tell the batch files apart when
  355. you're inside X-MASTER.  Did you notice the "rem" statement in the batch
  356. file given earlier?  REM statements are simply "rem"arks made about the
  357. batch file.  They do nothing to alter the operation of a batch file. If
  358. you put a "rem" statement as the first line of your batch file, X-MASTER
  359. will show the first forty characters following the "rem " instead of an
  360. ambiguous "Batch file #2".
  361.  
  362.  
  363. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  364.  
  365.  
  366.                        ** Notes on batch files **
  367.  
  368.     Batch files can be very powerful, however, you must take care in
  369. using them.  If you load a program into memory, it *must* be taken out
  370. of memory before it will come back to X-MASTER.  This is especially
  371. important when working with TSR programs.  I personally use KEY-FAKE a
  372. lot (stuffs keys into the keyboard buffer) but it must be taken out of
  373. memory (via MARK/RELEASE) before it will work with X-MASTER.  If you
  374. find yourself being dropped to DOS after playing a file, make sure the
  375. memory is the same when going back to X-MASTER as when you left.
  376.  
  377.     Another thing to remember about batch files is any program that can
  378. be run from DOS can be run from a batch file.  This gives you a great
  379. variety of programs which can be incorporated into your X-MASTER batch
  380. files.  Be creative!
  381.  
  382. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  383.  
  384.  
  385. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  386.  
  387.  
  388.                     ** Getting around in X-MASTER **
  389.  
  390.     When you load up the program, you will see a list of extension
  391. types.  These should be the same as the ones you have listed in your
  392. configuration file.  Use the arrow keys or the mouse to select which
  393. extension you want, and either press [RETURN] or the one of the mouse
  394. buttons.  The screen will then clear, and all the files in the specified
  395. directory of the selected extension will appear.  Use the arrow keys to
  396. move the cursor around, and press RETURN to "use" the file you have
  397. selected.  Press [PgDn] to go down a page, or press [PgUp] to go up a
  398. page. [Home] takes you to the first file, while [End] takes you to the
  399. last file. [Ctrl-Left-Arrow] takes you to the first item on the line,
  400. and [Ctrl-Right-Arrow] takes you to the last item on a line.  Also, if
  401. you press the first letter of the file name, it will take you to the
  402. next file which starts with that letter.  If your list is sorted (see
  403. below), it will take you to all the files which start with that letter.
  404.  
  405.     Mouse users may move the pointer to the appropriate file and double
  406. click the first (left) mouse button.  To go up or down a page, click
  407. either button on the words "PgUp" or "PgDn" respectively.
  408.  
  409.  
  410. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  411.  
  412.  
  413. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  414.  
  415.  
  416.                         ** Options available **
  417.  
  418.     When you have a lot of files and you want to play a bunch of them,
  419. you can tag each file you wish to play by pressing the [SPACE BAR].  The
  420. tag switch works like a toggle, so if you tag a file which you do not
  421. want, just press the [SPACE BAR] again.  Mouse users may press the right
  422. mouse button to tag or untag.
  423.  
  424.     When you have finished tagging files, press [RETURN] to "use" them.
  425. Alternatively, you can hit [Ctrl-Enter] or [Alt-Enter] and it will
  426. extract *ALL* files to the work directory, and then give you the option
  427. of running one of the executables that was extracted.  This is great for
  428. a multi-disk demo (like 2nd Reality!).  If you use a player (like DMP)
  429. which supports the @ style playlist, it will use the play list file
  430. instead.
  431.  
  432.     If you are using a normal extension, you will be given the option to
  433. "use" them in sequential order (the order in which they appear on the
  434. screen), or random order.
  435.  
  436.     If you wish to abort a "tagged play run", press the [SPACE BAR] or
  437. the [Escape] key between files.  Be careful, if you press ESC too many
  438. times, you will exit the program.  I would recommend using the [SPACE
  439. BAR], but for those of us that are quick, the [ESC] works just as well.
  440. Starting with release 2.0, there is a three second delay between each
  441. file, so use any OTHER key besides Space or ESC to abort the delay.  Use
  442. [SPACE BAR] or [ESC] to abort the tagged play run as usual.
  443.  
  444.     Each of the following keys have special functions as well.  They are
  445. as follows :
  446.  
  447. Alt-H,
  448. Alt-Z - Utilities Menu / Help
  449.  
  450.         - The first time you hit it, a menu will pop up containing all
  451.             the major functions.  From this menu, you can select any of
  452.             the other options.  If you select the Help option, you will
  453.             see an online help screen with the basic functions outlined.
  454.             Not extensive, but it will explain parts of the program.
  455.  
  456. Alt-C - Change Directory
  457.  
  458.         - If you wish to change the current directory to another, choose
  459.             this function.  Be careful, a config file is created for
  460.             every directory you select.  Not that this is bad, but it
  461.             wastes disk space if you select directories without any
  462.             files in it.  If you have a few directories which you keep
  463.             files in already defined, press F2 again to pick from your
  464.             currently defined directories.  This reduces typing to a
  465.             minimum!  Personally, I keep all the files I like in one
  466.             directory, and all the new ones, which are not backed up to
  467.             disk, I keep in another directory.  This aids in easy
  468.             organization.  If you accidently create a directory that you
  469.             no longer need, press Alt-D from the F2 pick list to delete
  470.             it.
  471.  
  472. Alt-E - Change current extension
  473.  
  474.         - With this command, you may switch to any of the extensions you
  475.             have defined in your CFG file.  The directory will be
  476.             changed to the default directory as specified in the CFG
  477.             file, and if no AutoMagic file is found, one will be
  478.             created.
  479.  
  480. Alt-D - Delete File
  481.  
  482.         - Whether this file is in a ZIP, ARJ, or LZH, or even
  483.             uncompressed, this command will delete the file the cursor
  484.             is currently on.  Be extra careful with this one as once its
  485.             deleted, its gone for good.
  486.  
  487. Alt-O - Sort (Order) the Files
  488.  
  489.         - Simple enough, all the files with be sorted to aid in easy
  490.             finding.  A menu will pop up asking you how you want to do
  491.             the sort: either by name, extension, size or time.  Then it
  492.             will ask you if you wish to save in sorted order.  If you
  493.             answer yes, it will be saved in that order UNTIL you do a
  494.             rescan.  You can hit Alt-R to reverse the order of the sort
  495.             as well.  This acts as a toggle so hit it again to go back
  496.             to a normal sort order.
  497.  
  498. Alt-N - Select New Player
  499.  
  500.         - You may have more than one batch file defined for use, and
  501.             with this command, you may switch between them.  The
  502.             currently selected one will be marked with a check mark or a
  503.             star.
  504.  
  505. Alt-R - Rescan
  506.  
  507.         - Depending if you are normal, master, or MEL mode, rescan will
  508.             either rescan the current directory, all the directories, or
  509.             rebuild the MEL respectively.  Use this command when you get
  510.             a new file you wish to use.
  511.  
  512. Alt-L - Use / Make MEL
  513.  
  514.         - A MEL is a Multiple Extension List.  With this option, you can
  515.             have your MOD's on the same screen as you FLI's or VOC's or
  516.             whatever.  Any extension goes!  I use this option so I can
  517.             view all my graphic files in one screen and all my music
  518.             files in another.  It makes it much easier when trying to
  519.             find something.  (See "Multiple Extension Lists (MEL's)")
  520.  
  521. Alt-M - Use / Make Master Directory
  522.  
  523.         - A master directory is a compiled list of all the currently
  524.             defined directories.  When you make a master list, you may
  525.             choose a file from any of the defined directories for the
  526.             same extension.  In other words, if you have all your MOD's
  527.             in two different directories, this will put all of them on
  528.             the screen.  This can be very useful if you keep files
  529.             spread out for some reason.  Personally, I keep all my new
  530.             MOD's in one directory, and the old MOD's in another.  This
  531.             way I can play from them both without switching directories.
  532.  
  533. Ctrl-Q - Quit
  534.  
  535.         - Return to DOS.
  536.  
  537. Alt-J - Jump to DOS
  538.  
  539.         - This will shell to DOS.  Type EXIT to return to X-MASTER.
  540.  
  541. Alt-S - Status window
  542.  
  543.         - When you are on a file, press Alt-S to see the status of the
  544.             file.  It includes most of the pertinent information such as
  545.             size (compressed and uncompressed), the file time/date, and
  546.             if compressed with ZIP or ARJ, the file description.  The
  547.             status will also tell you which archive it is in which is
  548.             great if you have duplicates.  You can selectively delete
  549.             from the right archive.
  550.  
  551. Alt-T - Selectively Tag All Files by Wildcard
  552.  
  553.         - Hit this button and it will ask you which files you want to
  554.             tag given a wildcard specification.  The default is *.* so
  555.             that would tag all files.
  556.  
  557. Alt-U - Selectively Untag All Files by Wildcard
  558.  
  559.         - Hit this button and it will ask you which files you want to
  560.             untag given a wildcard specification.  The default is *.* so
  561.             that would untag all files.
  562.  
  563.  
  564. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  565.  
  566.  
  567. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  568.  
  569.  
  570.                  ** Multiple Extension Lists (MEL's) **
  571.  
  572.     MEL's are a new way of keeping any extension accessable from one
  573. screen.  This may be useful in keeping a single music MEL with ALL the
  574. music type of files included.
  575.  
  576.     Setting up something such as this is very easy.  Hit the MEL key
  577. (Alt-L) and if you have never made a MEL, it will start you at the
  578. creation of a MEL.  If you have made one, press Alt-A to add more or
  579. Alt-D to delete one.
  580.  
  581.     The first thing you must do is tell it what extensions you want to
  582. use.  Tag (using the [SPACE BAR] as the toggle-tag key) all the
  583. extensions you wish to have included.  For our music example, tag your
  584. MOD, VOC, AMF, MTM, etc... extensions.  Press [RETURN] when done.
  585.  
  586.     Next, it will ask for a description.  This description is so when
  587. you select a MEL, you'll know which one your selecting.  Back to our
  588. music example, enter a description like "All music related files".
  589.  
  590.     That's the end of it!  You will now have all your music files in one
  591. screen and you can use X-MASTER as usual.  There are a couple of
  592. differences, however.  The Change Directory command is no longer active
  593. and the Change Batch File command works a little bit differently.  With
  594. a different set of extensions, you must first select which extension you
  595. want to change the default batch file, and then select the batch file.
  596.  
  597.  
  598. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  599.  
  600.  
  601.                          ** Mega-Extensions **
  602.  
  603.     Mega-Extensions means the extension involves extracting more than
  604. one file.  Sometimes it may be useful to extract a whole archive to the
  605. work directory, and then run a file from there (such as demos).  To
  606. define one, use the keywords "Mega_Ext" and "Mega_Ext_Dir" to define a
  607. unique three character extension and the included directories.  You
  608. *MUST* have a batch file for these extensions as well.  However, the
  609. batch file is very simplistic.  You can get by with just having a %1 in
  610. the batch file.  See the included DEMPLAY1.BAT for an example.
  611.  
  612.     Demos are the only thing that I use the Mega_Ext for; however, you
  613. could use the Mega_Ext for games as well.  You could define a "GAM"
  614. extension which would scan for all archives in a directory, and then you
  615. could tag all the disks of that game, and then extract them with the
  616. Ctrl-Enter command.
  617.  
  618.  
  619. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  620.  
  621.  
  622. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  623.  
  624.  
  625.                               ** Colors **
  626.  
  627.     X-MASTER is now color configurable in case you think my colors suck.
  628. I have included the default color scheme as well as another one made by
  629. Jeff Hancock (1:3600/7@fidonet) who is my beta tester.  I kind of like
  630. his better, but I kept the default in there.
  631.  
  632.     To install new colors, create a text file with one/more/all of the
  633. colors in it followed by an equals sign followed by your choice of
  634. color.  (For example : "YesNoText = Yellow").  You may imbed blank lines
  635. in this text file or insert comments with a semi-colon.  After doing
  636. this, run the program NEWCOL.EXE with the filename of the text file as
  637. its parameter.  (i.e.  NEWCOL newcol.txt).  If you leave off the
  638. filename, the default file name is COLORS.XM.  I recommend you edit the
  639. included sample color files for easier typing!  Last, but not least,
  640. make sure the XMASTER.EXE is not compressed or altered in any other form
  641. or it will not work.
  642.  
  643.     The colors are as follows :
  644.  
  645.         Black           DarkGray
  646.         Blue            Brown
  647.         Green           LightGreen
  648.         Cyan            LightCyan
  649.         Red             LightRed
  650.         Magenta         LightMagenta
  651.         Brown           Yellow
  652.         LightGray       White
  653.  
  654.     The positions are as follows :
  655.  
  656.         TitleBack           - background of the title box
  657.         TitleBoxBorder      - border of the title box
  658.         TitleBoxText        - text inside the title box
  659.         StatusBack          - background of the status box
  660.         StatusBorder        - border of the status box
  661.         StatusText          - text inside of the status box
  662.         StatusArchiveText   - the archive text is another color
  663.         InfoLineText        - the info line on the bottom of the screen
  664.         InfoLineBack        - background of the info line
  665.         DemoLineText        - the "UNREGISTERED" color
  666.         DemoLineBack        - the "UNREGISTERED" color background
  667.         FilesListBorder     - the main screen's border is this color
  668.         FilesListBox        - the main screen color
  669.         FileHBack           - the cursor background
  670.         FileHText           - the cursor text
  671.         PageText            - "what page you are on" color
  672.         CompressedName      - a compressed file is this color
  673.         UncompressedName    - an uncompressed file is this color
  674.         TagColor            - the tag character color
  675.         TitleFilesText      - the title line ("X-MASTER v...") text color
  676.         TitleFilesBack      - the title line background
  677.         ButtonBarText       - the buttons on the bottom of the screen
  678.         HelpText            - the help text color
  679.         HelpBack            - the help screen background
  680.         HelpBorder          - the help screen border color
  681.         HelpTitleText       - the help screen title color
  682.         HelpTitleBack       - the help screen title background color
  683.         HelpHorizLine       - the help screen horizontal line color
  684.         PauseText           - the pause in the help screen color
  685.         PauseBack           - the pause in the help screen background color
  686.         ErrorBoxBack        - the error box background color
  687.         ErrorBoxBorder      - the error box border color
  688.         ErrorText           - the error box text color
  689.         YesNoBack           - the yes/no box background color
  690.         YesNoBorder         - the yes/no box border color
  691.         YesNoText           - the yes/no box text color
  692.         MessageBoxBorder    - the message box border color
  693.         MessageBoxBack      - the message box background color
  694.         MessageBoxText      - the message box text color
  695.         DirEnterBack        - the "change directory" box background color
  696.         DirEnterBorder      - the "change directory" box border color
  697.         DirEnterText        - the "change directory" box text color
  698.         DirTypeText         - the "change directory" type text color
  699.         DirTypeBack         - the "change directory" type background color
  700.         PickListNBoxBack    - a pick list normal background color
  701.         PickListNBoxText    - a pick list normal text color
  702.         PickListHBoxBack    - a pick list highlighted background color
  703.         PickListHBoxText    - a pick list highlighted text color
  704.         PickListBorder      - a pick list border color
  705.         PauseWindowBoxBack  - the pause window background color
  706.         PauseWindowBoxText  - the pause window text color
  707.         PauseWindowBorder   - the pause window border color
  708.         PlayTaggedNBoxBack  - the play tagged box normal background color
  709.         PlayTaggedNBoxText  - the play tagged box normal text color
  710.         PlayTaggedHBoxBack  - the play tagged box highlight background color
  711.         PlayTaggedHBoxText  - the play tagged box highlight text color
  712.         PlayTaggedBoxBorder - the play tagged box border color
  713.         PlayTaggedBoxText   - the play tagged box text color
  714.         MainMenuHText       - the main menu highlight text color
  715.         MainMenuHBack       - the main menu highlight background color
  716.         MainMenuNBack       - the main menu normal background color
  717.         MainMenuNText       - the main menu normal text color
  718.         MainMenuBorder      - the main menu border color
  719.         MainMenuOptions     - the main menu options color
  720.  
  721.  
  722. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  723.  
  724.  
  725.                           ** NON-VGA users! **
  726.  
  727.     With VGA the standard these days, NON-VGA users have a little more
  728. work to do.  (EGA users shouldn't have to do this, but I'm not sure)
  729. First, edit the COLORS.XM file and go to the very end of the file.
  730. Uncomment (remove the leading semi-colon) the last five lines where it
  731. says "NON-VGA Colors" above the section.  Run NEWCOL.EXE which stores the
  732. new colors.  You're set!
  733.  
  734.  
  735. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  736.  
  737.  
  738.                              ** XMREPORT **
  739.  
  740.     XMREPORT.EXE is a little utility that lets you find out the contents
  741. of the data files.  You can use it to create hard copies of what files
  742. you have in what directories and how much space they take up.  Having
  743. this information in hard copy form can ease in tracking duplicates.
  744.  
  745.     This is available in the registered version only.
  746.  
  747.  
  748. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  749.  
  750. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  751.  
  752.  
  753.                      ** Files in use by X-MASTER **
  754.  
  755.     X-MASTER requires a number of data files and it is recommended that
  756. you keep X-MASTER in its own directory.  In addition to all the batch
  757. files, you may have created, it keeps one XM-ext.??? per directory of an
  758. extension.  Lastly, it will keep all the master lists in a XM-ext.MST,
  759. and all the MEL's in a XM-number.MEL.  Furthermore, there is the
  760. XMASTER.CFG file.  Any other files may be deleted.
  761.  
  762.  
  763. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  764.  
  765.  
  766.                        ** Optimizing X-MASTER! **
  767.  
  768.     X-MASTER uses a routine to swap to EMS/XMS/DISK when it needs extra
  769. memory.  For fastest results, have 450k of free EMS/XMS memory
  770. available.  Granted, this is not always possible.  If X-MASTER can not
  771. find the memory, it will swap to disk.  When swapping to disk, you have
  772. a number of options open to you.  If you have a designated place for
  773. such a swap file to go (such as a RAM disk), you can set the TMP/TEMP
  774. variable to this location.  If you run Windows or something similar, you
  775. may already have such a location in your environment.  To do this from
  776. DOS, type the following :
  777.  
  778.         SET TEMP=D:\TEMP
  779.  
  780.     This sets the TEMP directory to D:\TEMP.  Everytime X-MASTER swaps,
  781. it will write its swap file here.  X-MASTER will also read a TMP
  782. variable as the same thing.  Be warned, if you already have X-MASTER
  783. uncompressing the files to a certain place, and send your swap file
  784. there as well, you may run out of disk space.  Be careful...
  785.  
  786.     Lastly, with version 2.0, you can multiple work directories defined.
  787. X-MASTER will use them in the order put in the CFG file.  With this in
  788. mind, put the fastest work directory at the top and the slowest one with
  789. the most room at the bottom.  X-MASTER will extract to the first one it
  790. finds with the most room.
  791.  
  792.  
  793. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  794.  
  795.  
  796.                           ** Why X-MASTER? **
  797.  
  798.     Why should you use X-MASTER?  Simply because I can't find anything
  799. better!  I have honestly tried to find stuff that does everything my
  800. program does, and it just doesn't exist!  There were quite a few for the
  801. ADLIB ROL files, but when there are so many other (and better) music
  802. files, then you must switch to another program or worse still, do all
  803. of the work manually.  I tried about six programs which did something
  804. similar to my program, the program sucked.
  805.  
  806.     If you do find a program which you like better or it has a neat
  807. feature you wish mine had, let me know what I can change.  I'll consider
  808. it, and if its good, I will add it.  I am always interested in new
  809. ideas.  Most of the features in this program are user suggested,
  810. especially with these later versions.  In fact, all suggestions that
  811. were given to me on my poll on the demos newsgroup were added!
  812.  
  813.  
  814. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  815.  
  816.  
  817. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  818.  
  819.  
  820.                           ** Known pitfalls **
  821.  
  822.     Make sure all the archived files are archived correctly with no
  823. errors.  If you find yourself getting a Runtime Error #100, check your
  824. archives for errors.  The program, as of version 1.03, will call your
  825. attention to bad archives, and skip them.
  826.  
  827.     Bad archives are generally to blame for any Runtime Errors between
  828. 100 and 105.  If you find yourself getting one of these errors, test all
  829. your archives.  Next, make sure the archive is made with the latest
  830. version of the archiver.  Problems have been known to come up if you are
  831. using an archive that was made with an older version of the archiver.
  832. The program was tested with ARJ 2.41, PKZIP / PKUNZIP 2.04g, and LHA
  833. 2.13.  These are the latest releases as of this writing.
  834.  
  835.     Also, if you file PKUNZIP is not extracting a file in a ZIP, make
  836. sure the file is not in a subdirectory.  This will cause problems...
  837.  
  838.     I tried making the program as fast as possible, and on my 486/40,
  839. the program is quite fast.  If your computer is slow, use PKZIP and a
  840. RAMDRIVE for best results.  The majority of the slowness is due to the
  841. unarchiving process, and there is really nothing I can do about that.
  842.  
  843.  
  844. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  845.  
  846.  
  847.                          ** Troubleshooting **
  848.  
  849.     If you have any problem with X-MASTER acting weird, try testing the
  850. archives to make sure there are no errors in the archive.  Lastly, make
  851. sure the archiver isn't newer than X-MASTER.  In some cases, this won't
  852. cause a problem, but sometimes it will.
  853.  
  854.     If for some reason an extension isn't working, make sure the
  855. ???PLAY?.BAT exists and works.  If you're not sure that the batch file
  856. is being run, put the "pause" command at the end of the batch file.  It
  857. will prompt for a keypress before returning to X-MASTER.
  858.  
  859.     If everything keeps blinking, you may have a cheap EGA/VGA card.
  860. Use the command line option "/NOGUI" or change the colors using
  861. NEWCOL.EXE.  (See "Colors")
  862.  
  863.     If you're using the program under OS/2, it has a small problem when
  864. loading up the first time.  It will blank the screen, and it looks like
  865. nothing works.  Hit ESC and then run the program again.  Everything will
  866. be fine.
  867.  
  868.     If you are totally stuck at this point, by all means contact me.
  869.  
  870.  
  871. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  872.  
  873.  
  874. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  875.  
  876.  
  877.                        ** Command line options **
  878.  
  879.     Currently, very little can be done on the command line, but the
  880. following items may help you out a bit.  If, for example, you find the
  881. mouse cursor annoying or not working, or the program starts blinking, or
  882. you find my fonts not working, or almost anything video wise not
  883. working, use the /NOGUI command.
  884.  
  885.     If you find that X-MASTER can not adequately return your video mode
  886. back to normal after playing a file, use the /FV switch.  A Paradise
  887. card owner has said that it can't quite return to 43/50 line modes, so
  888. if you have this problem, use the /FV switch and put the MODE commands
  889. in your batch file used to play/use the file.
  890.  
  891.     Hopefully you keep all your X-MASTER files in the same directory
  892. in your path.  This would include all the XM-*.??? files, the CFG file,
  893. the *.MST files, the *.MEL files, and of course the EXE file.  X-MASTER
  894. will use the directory X-MASTER is run from as the starting directory.
  895. This being the case, the starting directory parameter is no longer
  896. necessary, but if for some reason you need it, it is still supported.
  897.  
  898.  
  899.     Examples :
  900.  
  901.         XMASTER /NOGUI
  902.  
  903.             Start XMASTER in primitive video mode.
  904.  
  905.         XMASTER C:\UTIL
  906.  
  907.             Start XMASTER with the starting directory as C:\UTIL.
  908.  
  909.         XMASTER E:\XM /NOGUI
  910.  
  911.             Start XMASTER with the starting directory as E:\XM in
  912.             primitive video mode.
  913.  
  914.  
  915. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  916.  
  917.  
  918. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  919.  
  920.  
  921.                         ** Tested extensions **
  922.  
  923.     I have tested a few of these extensions out with my program and
  924. found that they work well with my program.  I'd be interested in any you
  925. have added, and if you are writing a program which plays / views / uses
  926. a certain extension'ed file, please make it accept a full path name on
  927. the command line.  Here are some of the ones I tested :
  928.  
  929. MOD's
  930. -----
  931.     I have used TrakBlaster by Volker Zinke with this program ex-
  932.     tensively, and it works great.  The latest version I have is 2.0.
  933.     I have also used MODPLAY by Mark J. Cox.  The version I have does
  934.     not accept file names on the command line very easily, so I wrote a
  935.     program which seperated what my program sent out, and changed the
  936.     drive/path to be the one with the MOD file, and then did MP
  937.     <filename>.  Check out the SPLCMD files for an easy way to do this.
  938.  
  939. VOC's
  940. -----
  941.     I have used Creative Labs Voice Player (VPLAY) with my program and
  942.     it works fine.  Furthermore, if you keep your VOC files in normal 
  943.     packing method (uncompressed), they can be used with NOHISS or
  944.     SEEVOX quite nicely.
  945.  
  946. STM's
  947. -----
  948.     The only player I have seen for this is STM by Sami Tammilehto.  It
  949.     works fine with this program.
  950.  
  951. ROL's
  952. -----
  953.     There are a bunch of ROL player's out there which work with this
  954.     program.  I use the player called ADMPLAY which works great.
  955.     PLAYROL works, as does INTUNE.
  956.  
  957. CMF's or CMS's
  958. --------------
  959.     These are more Sound Master music files, and they work with PLAYCMF 
  960.     that is supplied by Creative Labs.  Apparantly, there are more
  961.     players out there, but this is the only one I've seen and it works
  962.     fine.
  963.  
  964. MID's
  965. -----
  966.     I have yet to find a DECENT MID file player that accepts parameters
  967.     from the command line.  The one I have is OK, but not great.  I'd be 
  968.     interested in any I could get, or you could supply me.  :)
  969.  
  970. GL's
  971. ----
  972.     These movies can viewed with GRASPRT.EXE quite nicely provided they
  973.     do not require more than 565k or so of memory.
  974.  
  975. FLI's
  976. -----
  977.     These work well with AAPLAY.EXE.
  978.  
  979. As stated earlier, I'd be interested in any other extensions / players
  980. you come up with.  The program is ready for ANY type of extension, even
  981. the ones that don't currently exist!
  982.  
  983.  
  984. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  985.  
  986.  
  987.                       ** Contacting the author **
  988.  
  989.     Hopefully, you found this program of use and bug free, but if not,
  990. or if you have a suggestion, please contact me.  I have several
  991. electronic mail addresses and if all else fails, snail mail works.  The
  992. address is at the end of this document.
  993.  
  994.     Fidonet users can contact me through the Adlib or SoundNet echos or
  995. netmail at 1:387/800.625.  I also frequent the Pascal echo, but X-MASTER
  996. is off topic in there (unless you have a programming question)!
  997.  
  998.     For Internet users, contact me at one of the following addresses :
  999.  
  1000.         jmukherj@ringer.cs.utsa.edu
  1001.         joy@runner.cs.utsa.edu
  1002.  
  1003.     Try contacting in that order as well...
  1004.  
  1005.     I frequent a few BBS' in my area (210).  Try calling them sometime :
  1006.  
  1007. Last Chance BBS - 210-822-7519 - TBBS - Offers a little bit of
  1008.     everything.  Zyxel, vFC, and 14.4 speeds.  Seven nodes!
  1009.     Sysops - George Brann and Tim Downey
  1010.  
  1011. Picture Express - 210-666-4842 - PC-BOARD 15.0 - Specializes in graphics
  1012.     and anything having to do with them.  vFC speeds.
  1013.     Sysop - David Steward
  1014.  
  1015. RoboTech BBS - 904-758-9477 - Searchlight system - Has bunches of music
  1016.     stuff on this BBS and the newest versions of this program.  No file
  1017.     ratios / no byte limit to keep / no life history required / first
  1018.     call downloads - H16/V32Turbo/V42bis/V32 speeds.
  1019.     Sysop - Jeff Hancock
  1020.  
  1021.  
  1022. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  1023.  
  1024.  
  1025.                          ** Kudos, Legal BS **
  1026.  
  1027.     I wish to thank all the people who helped with this program, namely
  1028. Fred Hewit, Chris Tio, Greg Collins, Daniel Hermann, Jeff Hancock, and
  1029. all the people who release source code into the public domain, including
  1030. many of the people in the Pascal and Adlib Echo whose names escape me...
  1031.  
  1032.     I use the following units/libraries in this program : the Turbo
  1033. Technojocks Toolbox, Thomas Wagner's excellent swapping routines, Max
  1034. Maischein's SPCFONT, Dave Kirsch's MOU routines for the graphical mouse
  1035. cursor (translated by DJ Murdoch) and an assortment of PD/Freeware
  1036. routines I've picked up along the way.
  1037.  
  1038.                           --- Thanks guys! ---
  1039.  
  1040.  
  1041. Lawyers, take note :
  1042.  
  1043.     This program here is offered as is, without warranties of any kind.
  1044. By using this program, you agree that the author is in no way
  1045. responsible for any damage done by this program.  Simple.  Anything that
  1046. happens isn't my fault.
  1047.  
  1048. Enjoy!
  1049.  
  1050.  
  1051. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  1052.  
  1053.  
  1054.                             ** Shareware! **
  1055.  
  1056.     SHAREWARE means you try the program before you buy it.  If you like
  1057. and use the program, you are asked to pay for it.  No one is forcing
  1058. your hand at paying for it, but your conscious will bother you for the
  1059. rest of your life if you choose not to....  I am not a rich person, and
  1060. enjoy programming, but in order to pay the bills, a monetary con-
  1061. tribution of $15.00 or more would be most appreciated.  $15 is not a
  1062. great deal of money to pay for a program, and if you use it as often as
  1063. I do, it should be well worth the money.  Send your contribution to :
  1064.  
  1065.                 Mr. Joey Mukherjee
  1066.                 202 Vanderheck #1
  1067.                 San Antonio, TX, 78209-4045
  1068.  
  1069.     Any correspondence as well can be forwarded to this address, and
  1070. would appreciate any bug reports or innovative uses of this program.
  1071. Thank you for your support...
  1072.  
  1073.  
  1074. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  1075.  
  1076.  
  1077.                           ** Why register? **
  1078.  
  1079.     Registering is really the right thing to do if you find X-MASTER
  1080. useful and plan on using it past the 30 day trial period.  Besides your
  1081. conscious being clear, you will also get the latest version on disk
  1082. without the ten second delay at the beginning; without the line at the
  1083. bottom of the main screen, and with the limit of only five extensions
  1084. being raised to 40 which should be enough for anybody.
  1085.  
  1086.     Furthermore, you get a program which will give you a small report of
  1087. what file is where and what each of the data files contain.  This can be
  1088. useful if you like keep hard copy records of what files you have.
  1089.  
  1090.  
  1091. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  1092.  
  1093.  
  1094.                             ** Free copy? **
  1095.  
  1096.     Are you really cheap and would you like a FREE copy of the
  1097. registered version of X-MASTER?  If so, then you may be entitled to one.
  1098. To get a free copy of X-MASTER, you must be the primary author of a
  1099. player/viewer/whatever(!) that can be used with X-MASTER.  You must also
  1100. send me a registered copy of that product and endorse X-MASTER in your
  1101. product.  Lastly, you must have a way of receiving the file via
  1102. Internet.  A Fido translated address is unacceptable.
  1103.  
  1104.     If you can't program, try coming up with a great color scheme and
  1105. send it to me.  If I think its good enough, I'll include it in the next
  1106. release of X-MASTER and mention your name in the docs.  Of all the
  1107. entries received by June 30, 1995, the THREE best schemes will
  1108. receive a free copy of X-MASTER.  Once again, you must have an Internet
  1109. address that can receive a UUENCODED file.
  1110.  
  1111.     Basically, I don't want to pay to give someone else my program.
  1112.  
  1113.     If you have another program that you would like to trade registered
  1114. versions of, please let me know.  I might be interested.
  1115.  
  1116.  
  1117. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  1118.  
  1119.  
  1120.                            ** Vendor Info **
  1121.  
  1122.     X-MASTER is a welcome addition to any shareware distribution method.
  1123. If you wish to do so, you are welcome to without consent from the
  1124. author; however, if you publish a CD-ROM with X-MASTER on it,  please
  1125. consider sending a copy to the author as payment.  He'd be most
  1126. appreciative.
  1127.  
  1128.  
  1129. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  1130.  
  1131.  
  1132.     Thanks for any comments / suggestions / bug reports / criticisms
  1133. registered or not!  I really do enjoy hearing from people who like this
  1134. program.
  1135.  
  1136.  
  1137.     And above all, thanks for reading this far.
  1138.  
  1139.  
  1140. --END--
  1141.  
  1142.